home *** CD-ROM | disk | FTP | other *** search
/ Technotools / Technotools (Chestnut CD-ROM)(1993).ISO / utils / brm / brm.doc next >
Text File  |  1990-08-28  |  46KB  |  1,103 lines
  1.  
  2.  
  3.  
  4.  
  5.                                BrowseMaster 1.12
  6.  
  7.                            Copyright 1990 by New-Ware
  8.  
  9.                               All Rights Reserved
  10.  
  11.                       (tm)  ┌─────────┐
  12.                       ┌─────┴───┐     │ MEMBER
  13.                    ───│         │     │────────────────
  14.                       │  ┌──────┴──┐  │ Association of
  15.                       │  │         ├──┘   Shareware
  16.                       └──┤    ■    │    Professionals
  17.                    ──────│    ║    │───────────────────
  18.                          └────╨────┘
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                                  Contents
  29.  
  30.  
  31.             1  PROLOG  . . . . . . . . . . . . . . . . . . . . . . .  2
  32.             2  REGISTRATION  . . . . . . . . . . . . . . . . . . . .  3
  33.             3  VERSION HISTORY . . . . . . . . . . . . . . . . . . .  5
  34.             4  GENERAL DESCRIPTION . . . . . . . . . . . . . . . . .  5
  35.             5  SYSTEM REQUIREMENTS . . . . . . . . . . . . . . . . .  6
  36.             6  PROGRAM LIMITATIONS . . . . . . . . . . . . . . . . .  6
  37.             7  PROGRAM OPERATION . . . . . . . . . . . . . . . . . .  6
  38.                STARTING BROWSEMASTER . . . . . . . . . . . . . . . .  6
  39.                   COMMAND LINE PARAMETERS  . . . . . . . . . . . . .  6
  40.                MAIN DISPLAY  . . . . . . . . . . . . . . . . . . . .  7
  41.                   TOP STATUS LINE  . . . . . . . . . . . . . . . . .  7
  42.                   BOTTOM STATUS LINE . . . . . . . . . . . . . . . .  7
  43.                   HORIZONTAL SCROLL BAR  . . . . . . . . . . . . . .  7
  44.                   VERTICAL SCROLL BAR  . . . . . . . . . . . . . . .  8
  45.                BROWSEMASTER COMMANDS . . . . . . . . . . . . . . . .  8
  46.                   FUNCTION KEY COMMANDS  . . . . . . . . . . . . . .  8
  47.                   WINDOW MOVEMENT  . . . . . . . . . . . . . . . . .  9
  48.                   FILE COMMANDS  . . . . . . . . . . . . . . . . . .  9
  49.                   BLOCK COMMANDSS  . . . . . . . . . . . . . . . . .  9
  50.                   FILE MARKERS . . . . . . . . . . . . . . . . . . .  9
  51.                   SEARCH FOR TEXT  . . . . . . . . . . . . . . . . .  9
  52.                   AUTOSCROLL FEATURE . . . . . . . . . . . . . . . . 10
  53.                FILE LIST OPERATIONS  . . . . . . . . . . . . . . . . 10
  54.                   SELECTING A FILE . . . . . . . . . . . . . . . . . 10
  55.                   BROWSING A ZIP FILE  . . . . . . . . . . . . . . . 10
  56.                   UNZIPPING A FILE . . . . . . . . . . . . . . . . . 11
  57.                   FILE LIST SORTING  . . . . . . . . . . . . . . . . 11
  58.                   CHANGING DIRECTORIES . . . . . . . . . . . . . . . 11
  59.                   CHANGING DRIVES  . . . . . . . . . . . . . . . . . 11
  60.                   TAGGING FILES  . . . . . . . . . . . . . . . . . . 11
  61.                   SEQUENTIAL FILE LOADING  . . . . . . . . . . . . . 12
  62.                DIRECTORY TREE OPERATIONS . . . . . . . . . . . . . . 12
  63.                LOADING A NEW FILE  . . . . . . . . . . . . . . . . . 12
  64.                BLOCK OPERATIONS  . . . . . . . . . . . . . . . . . . 13
  65.                   MARKING BLOCKS . . . . . . . . . . . . . . . . . . 13
  66.                   BLOCK MANIPULATION . . . . . . . . . . . . . . . . 13
  67.                MISCELLANEOUS FEATURES  . . . . . . . . . . . . . . . 13
  68.                   HEX/ASCII MODE TOGGLING  . . . . . . . . . . . . . 13
  69.                   STRIP HIGH BITS  . . . . . . . . . . . . . . . . . 14
  70.                   HORIZONTAL SCROLLING . . . . . . . . . . . . . . . 14
  71.                   JUMPING TO A LINE  . . . . . . . . . . . . . . . . 14
  72.  
  73.  
  74.  
  75.                                        i
  76.  
  77.  
  78.  
  79.                   SEARCHING FOR TEXT . . . . . . . . . . . . . . . . 14
  80.                   FILE MARKERS . . . . . . . . . . . . . . . . . . . 14
  81.                   EXPANDING TABS . . . . . . . . . . . . . . . . . . 15
  82.                   SETTING THE FILE MASK  . . . . . . . . . . . . . . 15
  83.             8  FILE/DIRECTORY NAME SEARCH  . . . . . . . . . . . . . 15
  84.             9  MOUSE SUPPORT . . . . . . . . . . . . . . . . . . . . 15
  85.             10  EXITING BROWSEMASTER . . . . . . . . . . . . . . . . 16
  86.             11  BROWSEMASTER HELP  . . . . . . . . . . . . . . . . . 16
  87.             12  CREDITS  . . . . . . . . . . . . . . . . . . . . . . 16
  88.  
  89.          Index                                                       17
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.                                        ii
  133.  
  134.  
  135.     1  PROLOG
  136.  
  137.  
  138.         The program author, John J. Newlin, is an active member of the
  139.     Association of Shareware Professionals (ASP).  The ASP wants to make
  140.     sure that the Shareware principle works for you. If you are unable to
  141.     resolve a Shareware related problem with an ASP member by contacting the
  142.     member directly, ASP may be able to help. The ASP Ombudsman can help you
  143.     resolve a dispute or problem with an ASP member, but does not provide
  144.     technical support for members' products. Please write to the ASP
  145.     Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve
  146.     message via EASYPLEX to ASP Ombudsman 70007,3536.
  147.  
  148.                                    DISCLAIMER
  149.  
  150.          New-Ware hereby disclaims all warranties relating to this product,
  151.     whether express or implied, including without limitation any implied
  152.     warranties of merchantability or fitness for a particular purpose. New-
  153.     Ware cannot and will not be liable for any special, incidental,
  154.     consequential, indirect or similar damages due to loss of data or any
  155.     other reason, even if New-Ware or an authorized New-Ware agent has been
  156.     advised of the possibility of such damages.  In no event shall the
  157.     liability for any damages ever exceed the price paid for the license to
  158.     use software, regardless of the form and/or extent of the claim.  The
  159.     user of this program bears all risk as to the quality and performance of
  160.     the software.
  161.  
  162.                                      LICENSE
  163.  
  164.          BrowseMaster is a Shareware product.  As such, it is made available
  165.     to the general computing public for evaluation.  Evaluating users are
  166.     licensed to operate BrowseMaster on their personal computers for the
  167.     purpose of test and evaluation on a trial basis for a limited trial
  168.     period.  It is not possible to reasonably define any definitive limits
  169.     of a fair and equitable time period for evaluation, therefore it is left
  170.     to the user's judgment and sense of fair play as to the time required to
  171.     make a decision as to its usefulness.  If the user decides the program
  172.     is not of sufficient merit to warrant purchase through registration with
  173.     New-Ware, the program should be removed from their personal computer.
  174.     Otherwise, if the program is deemed useful and is in regular use on the
  175.     user's personal computer system, registration with New-Ware is required.
  176.  
  177.          Registered users are those users that use the program on a regular
  178.     basis and register with payment to New-Ware.  By virtue of registration
  179.     and payment for the program, registered users are granted a license to
  180.     continue to utilize the program on their personal computer for as long
  181.     as they choose.  This license authorizes the user to use the program on
  182.     any personal computer system he or she may own so long as the program is
  183.     operated on only one computer system at a time.  Registration also
  184.  
  185.  
  186.  
  187.  
  188.                                      - 2 -
  189.  
  190.  
  191.  
  192.     results in the user receiving a fully registered copy of the program and
  193.     special privileges on the New-Ware BBS.
  194.  
  195.  
  196.     2  REGISTRATION
  197.  
  198.  
  199.         BrowseMaster is sole property of New-Ware Shareware products. The
  200.     Shareware version, and ONLY that version, may be freely copied and
  201.     transferred to individual parties for evaluation purposes.  The
  202.     Shareware version, and ONLY that version, may be posted on Bulletin
  203.     Board systems (BBS) for electronic access as long as NO FEE is charged
  204.     for its distribution except for private BBS operations that charge a
  205.     regular user subscription fee.  Computer information services such as
  206.     Compuserve (CIS), Genie, etc., are authorized to post this product for
  207.     subscriber access.  The Shareware version of BrowseMaster may NOT be
  208.     distributed on diskette by any disk distributor/vendor that charges more
  209.     than $10.00 for the diskette upon which the program and attendant files
  210.     are recorded without written consent from New-Ware.
  211.  
  212.          BrowseMaster is a fully functional Shareware product.  Shareware is
  213.     a computer program distribution/marketing method that permits potential
  214.     buyers to thoroughly try the program prior to purchase. It is NOT free
  215.     and it is not in the Public Domain.  If, after evaluating the program,
  216.     you find it to be useful enough to use it on a regular basis, you are
  217.     expected to pay for it by registering with New-Ware. The registration
  218.     fee is $25.00 and the registered version, which is NOT distributed as
  219.     Shareware, will not contain the opening Shareware screen nor the closing
  220.     messages.
  221.  
  222.     You may register BrowseMaster in one of three ways:
  223.  
  224.     1) By mail with check or money order to:
  225.  
  226.                              New-Ware
  227.                              8050 Camino Kiosco
  228.                              San Diego, CA 92122-1820
  229.  
  230.     2) By telephone with Visa/Mastercard to:
  231.  
  232.                              New-Ware
  233.                              (619) 455-6225
  234.  
  235.     3) Electronically through the New-Ware BBS:
  236.  
  237.                    New-Ware Shareware Products BBS
  238.                    Running Wildcat! version 2.10p
  239.  
  240.                    (619) 450-3257 - Node #1 1200/2400/9600 (HST)
  241.                          455-5226 - Node #2 1200/2400
  242.  
  243.  
  244.  
  245.                                      - 3 -
  246.  
  247.  
  248.  
  249.     The New-Ware Shareware Products BBS operates 24 hours per day, 7 days
  250.     per week.  Node #1 is dedicated to registered users only.  Nodes #2 is
  251.     open to all callers.  Users registering via the BBS receive access to
  252.     the latest registered version within 1 day after leaving their credit
  253.     card data.  Users who register by mail or phone may also access the
  254.     registered version by BBS, but you  MUST log on and leave a comment to
  255.     the sysop to the effect that you are a registered user and desire
  256.     access.  The author can also on CIS via PPN 71535,665 (please use
  257.     EASYPLEX).
  258.  
  259.     This Shareware version of BrowseMaster may be freely copied and passed
  260.     on to other individual users for their evaluation.  Disk vendors and/or
  261.     distributors that desire to distribute BrowseMaster must adhere to the
  262.     guidelines presented in VENDOR.DOC.
  263.  
  264.     Press F-1 to bring up the main help topic window and then select the
  265.     REGISTRATION topic to view the BrowseMaster registration form.  This
  266.     form may be blocked and pasted into the editor at the current editor
  267.     cursor position by using the F-7 key (or ^K,B) to mark the block start,
  268.     the F-8 key (or ^K,K) to mark the end of the block.  Press the Ins key
  269.     to return to the editor, move the cursor to the desired position in the
  270.     editor, and press Ctrl-K,A to insert the blocked registration text.  The
  271.     form can then be filled out in the editor and printed with the F-7
  272.     (print entire edit buffer) key or by blocking the form text and pressing
  273.     Ctrl-K,P.
  274.  
  275.                          BrowseMaster Registration Form
  276.  
  277.     Name:                    __________________________
  278.  
  279.     Address:                 __________________________
  280.  
  281.     Address:                 __________________________
  282.  
  283.     City, State              ______________________  __
  284.  
  285.     Zip Code:                _____-____
  286.  
  287.     MasterCard/Visa #        ____ ____ ____ ____
  288.  
  289.     Expiration Date:         __/__
  290.  
  291.     Telephone:               (___) ___-____
  292.  
  293.     Circle One:    Check     MC   Visa      Money Order
  294.  
  295.     Enclosed is my registration fee for BrowseMaster   $25.00
  296.  
  297.     Sales Tax (California Residents MUST include)        1.81
  298.                                                        ______
  299.  
  300.  
  301.  
  302.                                      - 4 -
  303.  
  304.  
  305.  
  306.     Total Remitted:
  307.  
  308.          New-Ware supports its products.  One of the great strengths of the
  309.     Shareware concept is the interaction between the program author and the
  310.     users.  Many of the features contained in BrowseMaster are the result of
  311.     user input.  If you have a problem evaluating this program or desire to
  312.     make a suggestion or comment (or even a complaint), please do not
  313.     hesitate to contact New-Ware.  Even if you register BrowseMaster, if you
  314.     later determine that it is unsuitable for your use, you may contact
  315.     New-Ware for a refund.  It is not necessary that you be a registered
  316.     user to contact us for technical support.  Technical support will be
  317.     available through the U.S mail, telephone, or the New-Ware BBS.  Please
  318.     restrict voice calls for support to normal business hours (08:00 a.m to
  319.     05:00 p.m. PST/PDT).
  320.  
  321.  
  322.     3  VERSION HISTORY
  323.  
  324.  
  325.          1.10 - 08-26-90
  326.  
  327.               - Initial release.
  328.  
  329.          1.11 - 08-26-90
  330.  
  331.               - Added Autoscroll feature
  332.  
  333.          1.12 - 08-29-90
  334.  
  335.               - Added capability to operate in EGA/VGA 44/50 line
  336.                 mode.
  337.  
  338.               - Decreased amount of RAM required to view a ZIPPED
  339.                 file.
  340.  
  341.  
  342.     4  GENERAL DESCRIPTION
  343.  
  344.  
  345.          BrowseMaster, hereafter abbreviated as BRM, is a powerful, full-
  346.     featured file browsing utility designed to make the process of viewing
  347.     files as swift and painless as possible.  In addition to the capability
  348.     of browsing any and nearly any size file,  BRM provides extra features
  349.     designed to facilitate the location and selection of target files.  The
  350.     user may freely change drives and and directories through the use of
  351.     pop-up file and directory tree lists.  BRM is unique in its support for
  352.     building a sequence list of files to browse.  Once the list is built,
  353.     the files will be sequentially loaded into the browser at the touch of a
  354.     single keystroke.  Please read the remainder of this file for details on
  355.     more BRM features.
  356.  
  357.  
  358.  
  359.                                      - 5 -
  360.  
  361.  
  362.  
  363.     5  SYSTEM REQUIREMENTS
  364.  
  365.  
  366.          BRM is designed to operate on systems compatible with the IBM
  367.     PC/XT/AT and PS/2 family computers.  DOS 2.0 or greater is required.
  368.     Video text mode support is offered for monochrome, Hercules, CGA, EGA,
  369.     and VGA video systems.  Although BRM may be operated successfully on
  370.     floppy disks, it is primarily designed for larger fixed disk systems.
  371.     Approximately 300K of free RAM is required at run time.
  372.  
  373.  
  374.     6  PROGRAM LIMITATIONS
  375.  
  376.  
  377.          BRM is capable of browsing any type of file (ASCII or binary)
  378.     theoretically as large as 2 gigabytes.  The virtual browser page buffers
  379.     are given memory priority over the file and directory lists, therefore
  380.     the number of files per directory is limited 600 and the number of
  381.     directories per drive is limited to 210.  The more system RAM available
  382.     at run time, the better the browsing performance will be since more
  383.     memory will be available to the browser page buffers.
  384.  
  385.  
  386.     7  PROGRAM OPERATION
  387.  
  388.  
  389.     STARTING BROWSEMASTER
  390.  
  391.               BRM may be executed from anywhere in the system by placing the
  392.          program file, which may be renamed, in a directory that is
  393.          identified in the DOS PATH string.  This is not a requirement, but
  394.          facilitates access to the program.
  395.  
  396.               BRM may be executed with or without command line arguments as
  397.          detailed below.
  398.  
  399.               COMMAND LINE PARAMETERS
  400.  
  401.                    There two types of command line parameters accepted by
  402.               BRM at run time.  The first consists of DOS file names of
  403.               files that exist in the current directory.  If just one file
  404.               name is entered on the command line, the BRM will load and
  405.               permit browsing of that file.  If more than one file name is
  406.               entered on the command line, BRM will enter its sequential
  407.               file load mode.  In this mode, the first file on the command
  408.               line is loaded for browsing.  When the Esc key is pressed, BRM
  409.               will abandon the current file and load the next file in the
  410.               sequence.  This operation continues until the number of
  411.               entered file names is exhausted or the user presses the Del
  412.               key to abort the operation.
  413.  
  414.  
  415.  
  416.                                      - 6 -
  417.  
  418.  
  419.  
  420.               Here is an example:
  421.  
  422.                    BRM MYLETTER.TXT LIST.COM MYDATA MYDATA.1ST
  423.  
  424.                    The second type of command line parameter accepted is a
  425.               DOS file mask, which is a string which may contain the DOS
  426.               wild card characters of "*" and "?".  If BRM detects any wild
  427.               card characters in the entered command line parameter it will
  428.               immediately display the file list for the current directory
  429.               with the only the files matching the entered mask in the list.
  430.  
  431.                    If no command line parameter is entered, BRM will display
  432.               the file list of the current directory using a mask of "*.*".
  433.  
  434.     MAIN DISPLAY
  435.  
  436.               The main display consists of two status/message lines, one on
  437.          the top line of the screen and the other on the bottom line and two
  438.          scroll bars.  The contents of the file being browsed are displayed
  439.          between the top scroll bar and the bottom status line.
  440.  
  441.               TOP STATUS LINE
  442.  
  443.                    The top status line displays the current line and column
  444.               numbers, the size of the current file, the current system
  445.               date/time, and the active drive.
  446.  
  447.               BOTTOM STATUS LINE
  448.  
  449.                    The bottom status line contains the drive:\path\name of
  450.               the current file on the left and the current DOS file name
  451.               mask on the right.  This line is also used for issuing prompts
  452.               for user entry and for the status of the sequential file load
  453.               mode.  If a ZIPPED file is being browsed, both the name of the
  454.               parent ZIP file and the file being browsed will appear.
  455.  
  456.               HORIZONTAL SCROLL BAR
  457.  
  458.                    The second row of the screen contains a horizontal scorll
  459.               bar which has a slider bar that indicates the relative
  460.               horizontal position of the browse window.  The scroll bar is
  461.               also used for scrolling the browse window horizontally with
  462.               the mouse.  This is accomplished by placing the mouse cursor
  463.               on the bar at the desired relative window position on the bar
  464.               and clicking the left button.  This will scroll the browse
  465.               window horizontally to the selected relative position.  The
  466.               right and left arrows at the end of the scroll bar can be
  467.               clicked on to scroll the window 8 columns right and left,
  468.               respectively.
  469.  
  470.  
  471.  
  472.  
  473.                                      - 7 -
  474.  
  475.  
  476.  
  477.               VERTICAL SCROLL BAR
  478.  
  479.                    The far right column on the screen contains a vertical
  480.               scroll bar which has a slider bar that indicates the relative
  481.               veritical position of the browse window.  The scroll bar is
  482.               also used for moving through the file with a mouse.  This is
  483.               accomplished by placing the mouse cursor on the bar at the
  484.               desired relative position on the bar and clicking the left
  485.               button.  This will scroll the browser widow to the selected
  486.               relative vertical position.  The scroll bar also contains an
  487.               up arrow at the top and and down arrow at the bottom.
  488.               Clicking on these duplicates the PgUp/PgDn keyboard action.
  489.  
  490.     BROWSEMASTER COMMANDS
  491.  
  492.               BRM commands are relatively straightforward and easy to use.
  493.          Use the F-1 key to display a help screen that contains a summary of
  494.          all BRM commands.
  495.  
  496.               Note that several BRM commands are designed to act on a
  497.          specific line.  For example, entering a marker or pressing Ctrl-
  498.          RightArrow to move to the end of a line both act upon the line that
  499.          is on the top line of the browse display, just below the upper top
  500.          status line.  Also note that when using F-7 to mark the beginning
  501.          of a block, the block beginning is set to the beginning of the top
  502.          line in the browse display.  When F-8 is pressed to mark the block
  503.          end, it acts upon the top line of the display.  Alternatively,
  504.          Ctrl-B,K may be used to mark the last line of the display as the
  505.          block end.
  506.  
  507.               FUNCTION KEY COMMANDS
  508.  
  509.                    BRM provides one keystroke access to its major features
  510.               via function key commands.
  511.  
  512.               F1                       -    Help screen
  513.               F2                       -    Load file
  514.               F3                       -    Display file list
  515.               F4                       -    Set file mask
  516.               F5                       -    Display directory tree
  517.               F6                       -    Return to start directory
  518.               F7                       -    Mark block begin
  519.               F8                       -    Mark block end
  520.               F9                       -    Strip high bits
  521.               F10                      -    Quit to DOS
  522.               Ctrl-F7                  -    Start Autoscroll Up
  523.               Ctrl-F9                  -    Start Autoscroll Down
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.                                      - 8 -
  531.  
  532.  
  533.  
  534.               WINDOW MOVEMENT
  535.  
  536.               Down Arrow/Space Bar     -    Scroll down one line
  537.               Up Arrow                 -    Scroll up one line
  538.               PgDn                     -    Scroll down one page
  539.               PgUp                     -    Scroll down up one page
  540.               Home                     -    Move to top of file
  541.               End                      -    Move to end of file
  542.               Left Arrow               -    Scroll window left
  543.               Right Arrow              -    Scroll window right
  544.               Alt-J                    -    Jump to line number
  545.               "F,f",CtrlQ,F            -    Search for text
  546.               "H,h"                    -    Hexidecimal Search
  547.               "N,n",Ctrl-L             -    Continue search
  548.  
  549.               FILE COMMANDS
  550.  
  551.               Ctrl-K,N                 -    Load new file
  552.  
  553.               BLOCK COMMANDSS
  554.  
  555.               Ctrl-K,B or F7           -    Mark block begin
  556.               Ctrl-K,K or F8           -    Mark block end
  557.               Crtl-K,P                 -    Print block
  558.               Ctrl-K,W                 -    Write block to file
  559.               Ctrl-K,H                 -    Toggle block display
  560.               Ctrl-Q,B                 -    Go to block begin
  561.               Ctrl-Q,K                 -    Go to block end
  562.               Ctrl-B,F                 -    Block entire file
  563.  
  564.               FILE MARKERS
  565.  
  566.               Ctrl-K,O,Ctrl-K#         -    Set marker #(0..3)
  567.               Ctrl-Q,O,Ctrl-Q#         -    Jump to marker #(0..3)
  568.  
  569.               SEARCH FOR TEXT
  570.  
  571.                    Target search strings are limited to 30 ASCII characters
  572.               or 30 hexidecimal two-digit bytes.  Search options are "U" for
  573.               ignore case, "G" for global, and "B" for backward search.
  574.               Search options are not used in the hexidecmal search mode.
  575.  
  576.               "F,f"                    -    Find Text
  577.               "H,h"                    -    Hexidecimal Search
  578.               "N,n"                    -    Continue Searching
  579.  
  580.                    Press upper or lower "H" to initiate a hexidecimal
  581.               search.  The target hex list must be entered as a sequence of
  582.               two-digit hex bytes separated by a single space as in:
  583.  
  584.  
  585.  
  586.  
  587.                                      - 9 -
  588.  
  589.  
  590.  
  591.                    0b 47 5A 99 00 1f 3C
  592.  
  593.                    Note that the hex digits "A" through "F" may be in either
  594.               case.
  595.  
  596.               AUTOSCROLL FEATURE
  597.  
  598.                    BRM is the only file browser that incorporates the
  599.               Autoscroll feature.  This feature permits automatic hands of
  600.               scrolling through the file in both vertical directions.  To
  601.               start autoscroll, press Ctrl-F7 to start scrolling up or
  602.               Ctrl-F9 to start scrolling down.  The blinking message
  603.               "Autoscroll" will appear on the bottom status line and the
  604.               file will begin to scroll.  To increase the scroll rate, press
  605.               the up arrow and to decrease the scroll rate, press the down
  606.               arrow.  Autoscrolling may be paused by pressing the space bar
  607.               and resumed by pressing any other normal key.
  608.  
  609.                    The mouse may also be used to initiate autoscroll.  Place
  610.               the mouse cursor within 6 lines of the horizontal scroll bar
  611.               and press the left button to scroll up.  Place the mouse
  612.               cursor within 6 lines of the bottom status line and press the
  613.               left button.  Scrolling may be paused by holding down any
  614.               mouse button and resumed by releasing it.
  615.  
  616.                    Press the Esc key to abort autoscrolling.
  617.  
  618.     FILE LIST OPERATIONS
  619.  
  620.               BRM provides a quick and easy method of selecting a file or
  621.          files to browse.  Use the F-3 key to display a list of files in the
  622.          current directory.  The current directory is the last directory
  623.          accessed by BRM.  The displayed list will include all files in the
  624.          current directory, sorted by file name as a default.
  625.  
  626.               SELECTING A FILE
  627.  
  628.                    Use the file list to select a file or a group of files
  629.               for browsing.  To select a single file, move the cursor bar to
  630.               the desired file and press the Enter key.  The window will
  631.               disappear and the selected file will be loaded into the
  632.               browser.
  633.  
  634.               BROWSING A ZIP FILE
  635.  
  636.                    BRM has the capability to read the directory of a PKware
  637.               ZIP file and display it in a pop-up window.  The directory
  638.               list can be viewed just like the normal DOS file list.  To
  639.               browse a ZIP compressed file, place the cursor bar over the
  640.               target file and press return.  There will be a delay while BRM
  641.  
  642.  
  643.  
  644.                                      - 10 -
  645.  
  646.  
  647.  
  648.               calls PKUNZIP to decompress the file for browsing.  Note that
  649.               this feature requires that a copy of PKUNZIP.EXE be located in
  650.               a directory identified in the DOS path string.
  651.  
  652.                    When the Esc key is pressed to finish browsing the
  653.               compressed file, BRM will re-display the ZIP file directory
  654.               for further selection.  Press Esc at this point to return to
  655.               the file list.  The file that was in the browser when the ZIP
  656.               file browsing mode was initiated will be loaded back into the
  657.               browser.
  658.  
  659.               UNZIPPING A FILE
  660.  
  661.                    An individual file inside a ZIP file may be unzipped by
  662.               pressing Ctrl-U with the cursor bar over the desired
  663.               compressed file.  Note that the file will be UNZIPPED to the
  664.               same directory in which the parent ZIP file is located and
  665.               will OVERWRITE any file of the same name that exists in that
  666.               directory with no warning.
  667.  
  668.               FILE LIST SORTING
  669.  
  670.                    BRM offers three different methods of sorting files in
  671.               the displayed directory file list.  The default is by file
  672.               name, which is activated by the F-2 key when viewing the list.
  673.               Pressing F-3 sorts by file size and pressing F-4 sorts the
  674.               list by file date.  A file is selected for loading into the
  675.               browser by positioning the cursor over the file name and
  676.               pressing  then Enter key.  Note that directory tree names and
  677.               ZIP directory file names are not sorted by BRM.
  678.  
  679.               CHANGING DIRECTORIES
  680.  
  681.                    In addition to displaying files, BRM includes all
  682.               subdirectories of the current directory.  To change to one of
  683.               the subdirectories and display a list of files contained
  684.               therein, move the cursor to the desired subdirectory name and
  685.               press Enter.
  686.  
  687.               CHANGING DRIVES
  688.  
  689.                    The active drive may be changed by selecting one of the
  690.               drive letters that appears at the very top of the file list
  691.               display and pressing Enter.  BRM will then display a list of
  692.               all files in the default directory of the selected drive.
  693.  
  694.               TAGGING FILES
  695.  
  696.                    BRM offers a powerful sequential file loading facility
  697.               that is activated by "tagging" files in the file list.  To tag
  698.  
  699.  
  700.  
  701.                                      - 11 -
  702.  
  703.  
  704.  
  705.               a file, press the space bar or the Ins key with the cursor bar
  706.               over the desired file.  A set of special markers will enclose
  707.               the line of data pertinent to the tagged file.  To untag a
  708.               file, press the the space bar or the Del key with the cursor
  709.               bar over a previously tagged file.  The space bar toggles the
  710.               tag.  In other words, if the file is not tagged then the space
  711.               bar will tag it and if the file is tagged, the space bar will
  712.               untag it.  The Ins key will not untag a tagged file and the
  713.               Del key will not tag an untagged file.
  714.  
  715.                    Contiguous groups of files may also be tagged by using
  716.               the F-7 key to mark the beginning of the tag block and the F-8
  717.               key to mark the end of the tagged block.
  718.  
  719.                    Press the F-10 key while in the file list to initiate
  720.               sequential file browsing or press the Esc key to return to the
  721.               browser.
  722.  
  723.               SEQUENTIAL FILE LOADING
  724.  
  725.                    A tagged group of files may be loaded into the browser in
  726.               sequence by pressing the F-10 key after all the desired files
  727.               are tagged.  The file list window will disappear and the
  728.               browser will be loaded with the first marked file on the list.
  729.               After browsing that file, press the Esc key to load the next
  730.               file.  A sequential load status message will appear on the
  731.               bottom status line that indicates the number of tagged files
  732.               remaining to be loaded in sequence for browsing.  The load
  733.               sequence may be aborted at any time by pressing the Del key
  734.               while in the browse window.
  735.  
  736.     DIRECTORY TREE OPERATIONS
  737.  
  738.               Pressing the F-5 key while in the browse mode will bring up a
  739.          graphic directory tree listing of all the directories on the
  740.          current drive.  To select a new directory, move the cursor bar to
  741.          the desired directory name and press the Enter key.  To abort and
  742.          return to the browse mode, press the Esc key.
  743.  
  744.               When a directory is selected, BRM will then display the file
  745.          list for the the selected directory.  Files may then be tagged or
  746.          selected as described above.
  747.  
  748.     LOADING A NEW FILE
  749.  
  750.               A new file may be loaded into the browser via the file list as
  751.          described above or the user may elect to specify the new file by
  752.          typing in the file name.  In this case, press Ctrl-K,N and a prompt
  753.          for the new file name will appear on the bottom status line.  Entry
  754.  
  755.  
  756.  
  757.  
  758.                                      - 12 -
  759.  
  760.  
  761.  
  762.          of a valid DOS file name or drive:\path\filename.ext will effect
  763.          the loading of the desired file.
  764.  
  765.     BLOCK OPERATIONS
  766.  
  767.               BRM supports several useful functions that operate on marked
  768.          blocks of text in the browsed file.
  769.  
  770.               MARKING BLOCKS
  771.  
  772.                    Blocks of browsed file information may be manipulated via
  773.               the BRM block commands.  The mark block begin command is F-7
  774.               (or Ctrl-K,B) and marks the line that is at the top of the
  775.               browse window display.  The block end command is F-8 (or
  776.               Ctrl-K,K) and it marks the end of the block as the line that
  777.               appears at the top of the display.  Alternatively, the line
  778.               appearing at the bottom of the display may be marked as the
  779.               block end by pressing Ctrl-B,K.
  780.  
  781.                    The entire file may be marked as a block with a single
  782.               keystroke.  The F-9 key acts as a toggle to mark and unmark
  783.               the entire file at one time.
  784.  
  785.                    Once a block has been marked, it be distinguished by a
  786.               highlight video attribute.  The marked block may be displayed
  787.               or hidden with the Ctrl-K,H command.
  788.  
  789.               BLOCK MANIPULATION
  790.  
  791.                    A marked block may be sent to the printer via the Ctrl-
  792.               K,P command or to a user designated file with the Ctrl-K,W
  793.               command.  If Ctrl-K,W is pressed with a marked block visible,
  794.               BRM will prompt for a file name to write the block to.  If
  795.               only a file name is entered, i.e., no drive:\directory path is
  796.               included, the blocked text will be written to the specified
  797.               file in the directory from which BRM was loaded.  Otherwise,
  798.               it will be written to the specified drive:\directory.  Note
  799.               that if the user specifies a file name that already exists in
  800.               the destination directory, BRM will issue a warning and an
  801.               opportunity to continue the write or to abort.
  802.  
  803.     MISCELLANEOUS FEATURES
  804.  
  805.               HEX/ASCII MODE TOGGLING
  806.  
  807.                    BRM may be toggled between viewing the loaded file in the
  808.               hexidecimal mode, more suitable for binary file viewing, or
  809.               the ASCII text mode.  The Tab key, or alternatively the Ctrl-H
  810.               or Atl-H keys, may be used to toggle this mode.  Note that any
  811.               time BRM is commanded to load a file with the extension of
  812.  
  813.  
  814.  
  815.                                      - 13 -
  816.  
  817.  
  818.  
  819.               .COM, .EXE, .BIN, .ARC, .ZIP, or .LZH BRM will automatically
  820.               toggle into the hex mode.
  821.  
  822.               STRIP HIGH BITS
  823.  
  824.                    Some word processors, such as the famous WordStar, store
  825.               their files with control codes that use the high bit of a
  826.               stored character to indicate some special formatting feature.
  827.               Characters in the loaded file with the high bits set may be
  828.               filtered by pressing the F-9 key.
  829.  
  830.               HORIZONTAL SCROLLING
  831.  
  832.                    Some ASCII files may have lines longer than 79 characters
  833.               that extend beyond the right hand scroll bar.  BRM permits
  834.               scrolling to the right with the right arrow key and back to
  835.               the left with the left arrow key to view a 79 character
  836.               section of lines up to 500 characters in length.
  837.  
  838.               JUMPING TO A LINE
  839.  
  840.                    To jump the display to a specific line number in the
  841.               file, use the Alt-J command.  A prompt for the number of the
  842.               line will appear.  Enter the line number and if it is a valid
  843.               line number in the loaded file, BRM will move the browse
  844.               window to display that line.  The target line will be on the
  845.               top line of the browse display.
  846.  
  847.               SEARCHING FOR TEXT
  848.  
  849.                    The BRM search mode is activated by pressing Ctrl-Q,F.  A
  850.               prompt for the target string will appear on the bottom line.
  851.               The target string may be up to 30 characters in length.
  852.               Another prompt will follow the entry of the search string
  853.               which asks for the desired search options.  Valid search
  854.               options are "G" for global, "B" for search backwards, and "U"
  855.               for ignore character case.  If the target string is located by
  856.               BRM, the window will be moved to that section of the file and
  857.               the line in which the target string appears will be
  858.               highlighted.  To search for further occurrences of the target
  859.               string, press Ctrl-L.
  860.  
  861.               FILE MARKERS
  862.  
  863.                    Up to four markers may be placed into the browsed file.
  864.               These markers can then be jumped to.  To insert a marker, use
  865.               the cursor keys to move the line where the marker is to appear
  866.               to the top line of the screen and press Ctrl-K,O and then
  867.               Ctrl-K and a digit between 0 and 3.  BRM will place a
  868.               highlighted mark at the beginning of the line at the top of
  869.  
  870.  
  871.  
  872.                                      - 14 -
  873.  
  874.  
  875.  
  876.               the display.  To jump to this marker from anywhere in the
  877.               file, press Ctrl-Q,O and then Ctrl-Q and the appropriate digit
  878.               (between 0 and 3).
  879.  
  880.               EXPANDING TABS
  881.  
  882.                    Many word processors and text editors store ASCII files
  883.               with tabs as special characters.  To expand these tabs to 8
  884.               spaces each, press Ctrl-Q,T.
  885.  
  886.               SETTING THE FILE MASK
  887.  
  888.                    As a default, BRM uses the global DOS file mask of "*.*"
  889.               for file list viewing.  This may be changed to any desired
  890.               valid DOS file mask, including wildcards, by pressing the F-4
  891.               key.  A prompt for the new file mask entry will appear on the
  892.               bottom status/message line.  The next time the file list is
  893.               accessed, the new mask will be used and only those files in
  894.               the active directory that match the entered mask will be
  895.               listed in the display.  Note that the current file mask is
  896.               displayed on the right side of the bottom status line.
  897.  
  898.  
  899.     8  FILE/DIRECTORY NAME SEARCH
  900.  
  901.  
  902.          BRM provides a fast method of finding a file or directory name in a
  903.     displayed list.  Pressing a character key, i.e., "a", "M", etc., will
  904.     search the list for the first item starting with that character.  If
  905.     found, the cursor bar will jump to that item and display the character
  906.     in the lower left hand border of the window.  Pressing another character
  907.     key will add it to the search string.  For example, pressing "c" might
  908.     jump to a file named "CADCAM.TXT"; pressing "r" next might jump to a
  909.     file name "CRAZY.GLU" and will display "CR" in the lower left hand
  910.     frame.  The search string is cleared if no matching string is found in
  911.     the list or if a non-character key is pressed.
  912.  
  913.  
  914.     9  MOUSE SUPPORT
  915.  
  916.  
  917.          BRM provides complete comprehensive support for using the mouse in
  918.     the browse window, directory list, and file list.  Each of these windows
  919.     contains a scroll bar as described above.  To select a file or directory
  920.     from the appropriate list, move the mouse cursor to the target and press
  921.     the left button.  This action will move the cursor bar to the target
  922.     item.  Press the left and right buttons simultaneously to select the
  923.     item, which is the same as pressing the Enter key.  The right mouse
  924.     button acts the same as the Esc key.
  925.  
  926.  
  927.  
  928.  
  929.                                      - 15 -
  930.  
  931.  
  932.  
  933.     10  EXITING BROWSEMASTER
  934.  
  935.  
  936.          Exit to DOS from the browse screen by pressing the F-10 key or the
  937.     Alt-X key.
  938.  
  939.  
  940.     11  BROWSEMASTER HELP
  941.  
  942.  
  943.          All the BRM commands and information on BRM are summarized in a
  944.     help window that is accessible via the F-1 key in the browse, file list,
  945.     or directory list window.
  946.  
  947.  
  948.     12  CREDITS
  949.  
  950.  
  951.          New-Ware wishes to acknowledge that BrowseMaster has been written
  952.     entirely in Turbo Pascal 5.5.  Turbo Pascal is a superb product from
  953.     Borland International.
  954.  
  955.          BrowseMaster would not be the powerful, easy-to-use, full-featured
  956.     product that it is if it were not for the use of TurboPower Software's
  957.     Object Professional package.  This is the finest collection of high
  958.     level language support routines in the world, bar none.  No Turbo Pascal
  959.     programmer should be allowed in the same room with a computer without
  960.     it!
  961.  
  962.          No one producing a file browse utility should fail to acknowledge
  963.     the premier program of this genre - LIST by Vernon Buerg.  BrowseMaster
  964.     is not meant to compete head-to-head with this marvelous file viewer.
  965.     It is intended to provide an alternative file viewing utility with a
  966.     unique command interface to those who do not have need for the power and
  967.     complexity of LIST.  It is designed to be more "user friendly" to those
  968.     who have neither the time nor the inclination to steep themselves in all
  969.     the features available in a program like LIST.  Nevertheless, the author
  970.     acknowledges the overall superiority of LIST and the impressive skill of
  971.     Vernon Buerg.
  972.  
  973.          This document was prepared using Borland International's
  974.     outstanding Sprint word processor.
  975.  
  976.     Copyright 1990, all rights reserved
  977.  
  978.     New-Ware Shareware Products
  979.     8050 Camino Kiosco
  980.     San Diego, CA 92122-1820
  981.  
  982.  
  983.  
  984.  
  985.  
  986.                                      - 16 -
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.                                      Index
  997.  
  998.  
  999.             9                             file mask 7, 15
  1000.                                           file names 6
  1001.            A                              Find Text 9
  1002.            Alt-J command 14
  1003.            Alt-X key 16                   G
  1004.            ASP 2                          Genie 3
  1005.            ASP Ombudsman 2                Go to block begin 9
  1006.            Autoscroll feature 10          Go to block end 9
  1007.  
  1008.            B                              H
  1009.            block end 13                   Help screen 8
  1010.            Block entire file 9            help screen 8
  1011.            bottom status line 7           hexidecimal mode 13
  1012.            BrowseMaster Registration      Hexidecimal Search 9
  1013.               Form 4
  1014.                                           I
  1015.            C                              Ins key 12
  1016.            command line 6
  1017.            Compuserve 3                   J
  1018.            Continue search 9              Jump to line number 9
  1019.            Continue Searching 9           Jump to marker 9
  1020.  
  1021.            D                              L
  1022.            Del key 6, 12                  Load file 8
  1023.            directory tree 12              Load new file 9
  1024.            Display directory tree 8
  1025.            Display file list 8            M
  1026.            drive letters 11               main help topic 4
  1027.                                           mark block 13
  1028.            E                              Mark block begin 8, 9
  1029.            eft arrow key 14               Mark block end 8, 9
  1030.            Enter key. 11                  marked blocks 13
  1031.            Esc key 6, 12                  markers 14
  1032.            Exit to DOS 16                 mouse 15
  1033.                                           Move to end of file 9
  1034.            F                              Move to top of file 9
  1035.            F-10 key 12, 16
  1036.            F-1 key 8                      N
  1037.            F-3 key 10                     new file 12
  1038.            F-5 key 12                     New-Ware 4
  1039.            F-9 key 13, 14
  1040.  
  1041.  
  1042.  
  1043.                                      - 17 -
  1044.  
  1045.  
  1046.  
  1047.            P                              Set file mask 8
  1048.            Print block 9                  Set marker 9
  1049.                                           Shareware 2
  1050.            Q                              Shareware product 3
  1051.            Quit to DOS 8                  Shareware Products BBS 4
  1052.                                           slider bar 8
  1053.            R                              sorting files 11
  1054.            register 2                     space bar 12
  1055.            REGISTRATION topic 4           Start Autoscroll Down 8
  1056.            Return to start directory      Start Autoscroll Up 8
  1057.               8                           Strip high bits 8
  1058.            right arrow key 14             subdirectories 11
  1059.  
  1060.            S                              T
  1061.            scroll bar 8                   Tab key 13
  1062.            Scroll down one line 9         tabs 15
  1063.            Scroll down one page 9         Toggle block display 9
  1064.            Scroll down up one page 9      top status line 7
  1065.            Scroll up one line 9
  1066.            Scroll window left 9           W
  1067.            Scroll window right 9          Write block to file 9
  1068.            Search for text 9
  1069.            search mode 14                 Z
  1070.            search options 14              ZIP file 10
  1071.            sequential file browsing
  1072.               12
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.                                      - 18 -
  1101.  
  1102.  
  1103.